<HTML>
 <HEAD>
 <TITLE>Tool 180: SNTP client obtaining time</TITLE>
 </HEAD>
 <BODY BGCOLOR="#FFFFFF">
  <CENTER>   <H3>Tool 180: SNTP client obtaining time</H3>
  </CENTER>

  <P><H3>Description:</H3>
   <PRE>
  This tool queries a NTP/SNTP server in order to obtain time.
  We use SNTP because it is sufficient for requesting time.
  Displayed time is value of field Transmit_Timestamp from server,
  without adding the trip delay from server to client. So time is not
  really accurate, but it should be sufficient for most usages.
  Then, it can be used to set local clock (for example, under Unix,
  "date --set result_of_netwox_180_-u").
  
  Parameter --dst-ip is the address of remote host/server.
  Parameter --dst-port is the port number where to connect.
  Optional parameter --src-ip defines the local IP address to use.
  Optional parameter --src-port defines the local port number to use.
  Optional parameter --ip4opts permits to add IP4 options encoded as
  mixed.
  Optional parameter --ip6exts permits to add IP6 options encoded as
  mixed (first byte is the next header number).
  Optional parameters --device, --src-eth and --dst-eth permits to
  create a virtual client using fake addresses (in this case, tool have
  to be run with admin privilege in order to sniff and spoof at
  Ethernet level).
  
  Set --src-port to a random value greater than 1024 to use it
  without admin privilege.
   </PRE>

  <P><H3>Synonyms:</H3>
  &nbsp;&nbsp;date<BR>

  <P><H3>Usage:</H3>
  &nbsp;&nbsp;netwox 180 -i ip [-r|+r] [-u|+u] [-h|+h] [-s|+s] [-n|+n] [-d device] [-E eth] [-e eth] [-I ip] [-P port] [-p port] [-o ip4opts] [-O ip6exts] [-V uint32] [-T uint32]<BR>

  <P><H3>Parameters:</H3>
<TABLE BORDER=1 CELLPADDING=4>
 <TR>
  <TD ALIGN=middle><I>parameter</I></TD>
  <TD ALIGN=middle><I>description</I></TD>
  <TD ALIGN=middle><I>example</I></TD>
 </TR>
 <TR><TD><TT>-i|--dst-ip ip</TD>
<TD>destination IP address</TD>
<TD>5.6.7.8</TD></TR>
<TR><TD><TT>-r|--disp-rfc822|+r|--no-disp-rfc822</TD>
<TD>display rfc822 date</TD>
<TD><I>This boolean is set.<BR>Use + or --no- to unset it.</I></TD></TR>
<TR><TD><TT>-u|--disp-unixdate|+u|--no-disp-unixdate</TD>
<TD>display unix date(1) format</TD>
<TD>&nbsp;</TD></TR>
<TR><TD><TT>-h|--disp-human|+h|--no-disp-human</TD>
<TD>display human readable time</TD>
<TD>&nbsp;</TD></TR>
<TR><TD><TT>-s|--disp-sec|+s|--no-disp-sec</TD>
<TD>display seconds</TD>
<TD>&nbsp;</TD></TR>
<TR><TD><TT>-n|--disp-secnsec|+n|--no-disp-secnsec</TD>
<TD>display seconds and nanoseconds</TD>
<TD>&nbsp;</TD></TR>
<TR><TD><TT>-d|--device device</TD>
<TD>device name</TD>
<TD>Eth0</TD></TR>
<TR><TD><TT>-E|--src-eth eth</TD>
<TD>source ethernet address</TD>
<TD>0:2:3:4:5:6</TD></TR>
<TR><TD><TT>-e|--dst-eth eth</TD>
<TD>destination ethernet address</TD>
<TD>0:8:9:a:b:c</TD></TR>
<TR><TD><TT>-I|--src-ip ip</TD>
<TD>source IP address</TD>
<TD>192.168.100.200</TD></TR>
<TR><TD><TT>-P|--src-port port</TD>
<TD>source port number</TD>
<TD>0</TD></TR>
<TR><TD><TT>-p|--dst-port port</TD>
<TD>destination port number</TD>
<TD>123</TD></TR>
<TR><TD><TT>-o|--ip4opts ip4opts</TD>
<TD>IPv4 options</TD>
<TD>&nbsp;</TD></TR>
<TR><TD><TT>-O|--ip6exts ip6exts</TD>
<TD>IPv6 extensions</TD>
<TD>&nbsp;</TD></TR>
<TR><TD><TT>-V|--version uint32</TD>
<TD>protocol version</TD>
<TD>3</TD></TR>
<TR><TD><TT>-T|--timeout uint32</TD>
<TD>timeout in milliseconds</TD>
<TD>2000 </TD></TR>
</TABLE>

  <P><H3>Examples:</H3>
  &nbsp;&nbsp;netwox 180 -i "5.6.7.8"<BR>
<BR>
  &nbsp;&nbsp;netwox 180 --dst-ip "5.6.7.8"<BR>
<BR>
 </BODY>
 </HTML>
